IRIX Base Documentation 1998 November

home *** CD-ROM | disk | FTP | other *** search

/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Sgm / PuiPrintBox.z / PuiPrintBox

Wrap

Text File | 1998-10-30 | 127KB | 3,046 lines

PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) NNNNAAAAMMMMEEEE PuiPrintBox - print spooler interface widget SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS ####iiiinnnncccclllluuuuddddeeee <<<<SSSSggggmmmm////PPPPrrrriiiinnnnttttBBBBooooxxxx....hhhh>>>> Linkage: ............ ----llllpppprrrriiiinnnnttttuuuuiiii ----llllssssppppoooooooollll ----llllXXXXmmmm ----llllXXXXtttt ----llllXXXX11111111 ----llllggggeeeennnn ............ Instantiation Methods: wwwwiiiiddddggggeeeetttt ==== PPPPuuuuiiiiCCCCrrrreeeeaaaatttteeeePPPPrrrriiiinnnnttttBBBBooooxxxx((((ppppaaaarrrreeeennnntttt,,,, nnnnaaaammmmeeee,,,, aaaarrrrggggssss,,,, nnnnaaaarrrrggggssss))));;;; wwwwiiiiddddggggeeeetttt ==== PPPPuuuuiiiiCCCCrrrreeeeaaaatttteeeePPPPrrrriiiinnnnttttDDDDiiiiaaaalllloooogggg((((ppppaaaarrrreeeennnntttt,,,, nnnnaaaammmmeeee,,,, aaaarrrrggggssss,,,, nnnnaaaarrrrggggssss))));;;; wwwwiiiiddddggggeeeetttt ==== XXXXttttCCCCrrrreeeeaaaatttteeeeWWWWiiiiddddggggeeeetttt((((nnnnaaaammmmeeee,,,, ppppuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxxWWWWiiiiddddggggeeeettttCCCCllllaaaassssssss,,,, ppppaaaarrrreeeennnntttt,,,, aaaarrrrggggssss,,,, nnnnaaaarrrrggggssss))));;;; DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN The _P_u_i_P_r_i_n_t_B_o_x widget provides a graphical user interface to the _l_p printing command of the AT&T System V print spooling system. Using the PrintBox widget an application may submit a file or buffer for printing. In addition, the printer and options for the print job may be selected. The PrintBox widget contains six areas: - Filename entry area - Printer selection area - Job option area - Action area - Work area These areas are described below. FFFFiiiilllleeeennnnaaaammmmeeee eeeennnnttttrrrryyyy aaaarrrreeeeaaaa If the print job is a file, the filename area provides a text field to enter the name(s) of the file(s) to be printed. Multiple files may be specified with each filename being separated by whitespace. Bourne shell filename meta characters may be specified but job control and other meta characters should not be used and may be disallowed by the text field. This area will be displayed only if the PPPPuuuuiiiiNNNNjjjjoooobbbbTTTTyyyyppppeeee resource (described below) is set to PPPPuuuuiiiiPPPPRRRRIIIINNNNTTTTJJJJOOOOBBBB____FFFFIIIILLLLEEEENNNNAAAAMMMMEEEE and the PPPPuuuuiiiiNNNNsssshhhhoooowwwwFFFFiiiilllleeeennnnaaaammmmeeee resource is TTTTrrrruuuueeee. When present, the filename entry area is located in the upper left portion of the widget. PPPPrrrriiiinnnntttteeeerrrr sssseeeelllleeeeccccttttiiiioooonnnn aaaarrrreeeeaaaa The left portion of the PrintBox widget contains the printer selection area. This area displays a list of the printers available to the print spooling system. Any printer from the list may be selected for print job submittal. The PPPPuuuuiiiiNNNNddddeeeeffffaaaauuuullllttttPPPPrrrriiiinnnntttteeeerrrrFFFFoooonnnntttt resource can be used to differentiate the default printer from the other printers on the list. PPPPaaaaggggeeee 1111 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) JJJJoooobbbb ooooppppttttiiiioooonnnn aaaarrrreeeeaaaa This area on the right side of the widget provides controls for various print job options. Job parameters such as the number of copies and banner page title may be specified in this area. There is also a text field provided for specifying options unique to the printer selected. The job option area will not be displayed if the PPPPuuuuiiiiNNNNsssshhhhoooowwwwOOOOppppttttiiiioooonnnnssss resource (described below) is set to FFFFaaaallllsssseeee. Each option in the job option area can be selectively displayed by setting the appropriate resource (described below) to FFFFaaaallllsssseeee. AAAAccccttttiiiioooonnnn aaaarrrreeeeaaaa The action area is located at the bottom of the widget and contains the PrintBox action push buttons. There are five action area push buttons, three of which are displayed by default. The following buttons are managed (visible) by default: PPPPrrrriiiinnnntttt Submits the specified file or buffer for printing by the spooling system. First the functions registered on the PPPPuuuuiiiiNNNNpppprrrriiiinnnnttttCCCCaaaallllllllbbbbaaaacccckkkk list are invoked. Next, if the PPPPuuuuiiiiNNNNpppprrrriiiinnnnttttiiiinnnnggggPPPPoooolllliiiiccccyyyy resource is set to PPPPuuuuiiiiWWWWIIIIDDDDGGGGEEEETTTT____PPPPRRRRIIIINNNNTTTTIIIINNNNGGGG (the default), the PrintBox widget's internal function is called to submit the print job to the spooling system for printing. If PPPPuuuuiiiiNNNNpppprrrriiiinnnnttttiiiinnnnggggPPPPoooolllliiiiccccyyyy is set to PPPPuuuuiiiiAAAAPPPPPPPPLLLLIIIICCCCAAAATTTTIIIIOOOONNNN____PPPPRRRRIIIINNNNTTTTIIIINNNNGGGG, the widget's internal job submission function is not called, and it becomes the application's responsibility to submit the job for printing. If the print job was successfully submitted, the functions on the PPPPuuuuiiiiNNNNjjjjoooobbbbIIIInnnnffffooooCCCCaaaallllllllbbbbaaaacccckkkk list will be invoked. If an error has occurred submitting the job, the functions on the PPPPuuuuiiiiNNNNeeeerrrrrrrroooorrrrCCCCaaaallllllllbbbbaaaacccckkkk will be invoked. Finally, if the PrintBox widget's XXXXmmmmNNNNaaaauuuuttttooooUUUUnnnnmmmmaaaannnnaaaaggggeeee resource is set to TTTTrrrruuuueeee and the widget is a child of a DialogShell, the PrintBox will be automatically unmanaged (popped down) after the callback and print functions have been called. MMMMoooorrrreeee OOOOppppttttiiiioooonnnnssss............ Many printers provide specialized, vendor-specific options. The job option area provides a text type-in field for specifying these printer-specific options. However, some printers provide a graphical dialog for specifying the printer-specific options. If such a dialog is available for the selected printer, the MMMMoooorrrreeee OOOOppppttttiiiioooonnnnssss............ button will have a normal appearance. If no dialog is available, the button will appear grayed out. When the MMMMoooorrrreeee OOOOppppttttiiiioooonnnnssss............ button is pressed the graphical options dialog for the selected printer PPPPaaaaggggeeee 2222 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) will be displayed. At the same time, the printer- specific options type-in field in the job option area will be grayed out and not editable. When the desired options have been selected on the option dialog, the OOOOKKKK button on the dialog should be pressed. This will remove the dialog from the screen and will place text in the printer-specific options field in the job option area. This text represents the options selected on the graphical option dialog. An AAAAppppppppllllyyyy button is also available for specifying options without dismissing the dialog. Note that the type in field in the job option area becomes ungrayed and editable when the option dialog is no longer displayed. SSSSaaaavvvveeee OOOOppppttttiiiioooonnnnssss............ Brings up a dialog that allows spooler and printer- specific option settings to be saved to disk. The spooler option settings are written to the file ~/._g_l_p_r_c. Spooler options consist of all settings in the job option area except the printer-specific options type-in values and the number of copies. If printer-specific options have been modified for any listed printer, those printers are listed on the dialog. These options are stored on a per printer basis in files named /_v_a_r/_s_p_o_o_l/_l_p/_s_e_t_t_i_n_g_s/<_p_r_i_n_t_e_r _n_a_m_e>/<_u_s_e_r_n_a_m_e>. Note that the number of copies is not saved to either file since this option is more appropriately specified on the command line or via the job option are control. Printer-specific options cannot be saved for printer classes. If the PrintBox widget is created by either the user _r_o_o_t or _l_p (based on the uid at the time the widget is instantiated), the Save dialog permits the saving of printer-specific options for all users of the selected printer. CCCCaaaannnncccceeeellll Calls the functions registered on the PPPPuuuuiiiiNNNNccccaaaannnncccceeeellllCCCCaaaallllllllbbbbaaaacccckkkk list. This button normally is used to pop down the PrintBox widget when it is used as a pop up dialog. If the PrintBox widget's XXXXmmmmNNNNaaaauuuuttttooooUUUUnnnnmmmmaaaannnnaaaaggggeeee resource is set to TTTTrrrruuuueeee and the widget is a child of a DialogShell, the PrintBox will be automatically unmanaged (popped down) after the callback functions have been invoked. HHHHeeeellllpppp Calls the functions registered on the PPPPuuuuiiiiNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk list. In addition to these five buttons, there are four user- definable action area buttons that are unmanaged (invisible) by default. These buttons, called UUUUsssseeeerrrr1111, UUUUsssseeeerrrr2222, UUUUsssseeeerrrr3333 and UUUUsssseeeerrrr4444, PPPPaaaaggggeeee 3333 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) are positioned between the PPPPrrrriiiinnnntttt and CCCCaaaannnncccceeeellll buttons. These buttons may be managed using the _X_t_M_a_n_a_g_e_C_h_i_l_d function, specifying the widget ID for the desired button. The widget ID can be obtained from the _P_u_i_P_r_i_n_t_B_o_x_G_e_t_C_h_i_l_d function. When activated, the User buttons invoke the functions registered on their respective callback lists, PPPPuuuuiiiiNNNNuuuusssseeeerrrr1111CCCCaaaallllllllbbbbaaaacccckkkk PPPPuuuuiiiiNNNNuuuusssseeeerrrr2222CCCCaaaallllllllbbbbaaaacccckkkk, PPPPuuuuiiiiNNNNuuuusssseeeerrrr3333CCCCaaaallllllllbbbbaaaacccckkkk and PPPPuuuuiiiiNNNNuuuusssseeeerrrr4444CCCCaaaallllllllbbbbaaaacccckkkk. WWWWoooorrrrkkkk aaaarrrreeeeaaaa The PrintBox widget allows an application to specify one child widget. This widget would typically be a MMMMaaaannnnaaaaggggeeeerrrr class widget that would contain application-specific printing controls such as page number range. When present, the work area is placed at the top of the PrintBox and spans the entire width of the widget. SSSSeeeettttttttiiiinnnnggggssss FFFFiiiilllleeeessss When the PrintBox widget is created, it will read the file ._g_l_p_r_c if it exists in the user's home directory. This file is expected to contain a single line of System V spooler option switches. The switches are the same as those available on the _l_p command line except that the ----dddd, ----oooo and ----nnnn options must not be specified. On creation the PrintBox widget also looks for files named /_v_a_r/_s_p_o_o_l/_l_p/_s_e_t_t_i_n_g_s/<_p_r_i_n_t_e_r _n_a_m_e>/<_u_s_e_r_n_a_m_e> for each printer on the available printer list. For each printer, if the <_u_s_e_r_n_a_m_e> file is not found a file name _d_e_f_a_u_l_t_S_e_t_t_i_n_g_s will be read, if it exists. The file is expected to contain a single line of printer-specific options. The options are listed as they would be typed into the printer-specific options type-in field in the job options area. Any additional lines in the file will be ignored. Any printer-specific options specified on the command line will be appended to the options found in the settings file for the initially selected printer. Note that printer-specific options are maintained on a per printer, per user basis. When a new printer is selected from the list of available printers, any options specified for that printer will be displayed in the job option area. Spooler and printer-specific options can be saved using the SSSSaaaavvvveeee OOOOppppttttiiiioooonnnnssss............ button in the action area. The PrintBox widget reads the spooler and printer-specific options files when it is instantiated (e.g. when _X_t_C_r_e_a_t_e_W_i_d_g_e_t is called). The settings from these options files override any resource values for the corresponding options. Therefore, spooler and printer-specific option resources should not be set at the creation of the PrintBox widget. Spooler and printer-specific options resources should be set after widget creation using the _X_t_S_e_t_V_a_l_u_e_s function. CCCCllllaaaasssssssseeeessss The PrintBox widget inherits behavior and resources from the CCCCoooorrrreeee, CCCCoooommmmppppoooossssiiiitttteeee, CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt, XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr, and XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd widget classes. PPPPaaaaggggeeee 4444 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) The class pointer is ppppuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxxWWWWiiiiddddggggeeeettttCCCCllllaaaassssssss and the class name is PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx. NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss The following table defines a set of widget resources used by the programmer to specify data. The programmer can also set the resource values for the inherited classes to set attributes for this widget. To reference a resource by name or by class in a .Xdefaults file, remove the PPPPuuuuiiiiNNNN or PPPPuuuuiiiiCCCC prefix and use the remaining letters. To specify one of the defined constant values for a resource in a .Xdefaults file, use the constant name as listed (including the PPPPuuuuiiii prefix, the case and any underscores). The codes in the access column indicate whether the given resource can be set at creation time (CCCC), set by using XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (SSSS), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (GGGG), or is not applicable (NNNN////AAAA). PPPPaaaaggggeeee 5555 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) _____________________________________________________ PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx SSSSeeeettttuuuupppp RRRReeeessssoooouuuurrrrcccceeeessss ____________________________________________________ NNNNaaaammmmeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss CCCCllllaaaassssssss TTTTyyyyppppeeee ____________________________________________________ PuiNbuffer NULL CSG PuiCBuffer XtPointer ____________________________________________________ PuiNbufSize 0 CSG PuiCBufSize int ____________________________________________________ PuiNdefPrinter NULL G PuiCDefPrinter char* ____________________________________________________ PuiNfd 0 CSG PuiCFd int ____________________________________________________ PuiNfilename NULL CSG PuiCFilename char* ____________________________________________________ PuiNjobType PuiPRINTJOB_FILENAME CG PuiCJobType int ____________________________________________________ PuiNnumPrinters 0 G PuiCNumPrinters int ____________________________________________________ PuiNprinter dynamic CSG PuiCPrinter char* ____________________________________________________ PuiNprinterList NULL G PuiCPrinterList SLPrinterStruct* ____________________________________________________ PuiNprintingPolicy PuiWIDGET_PRINTING CSG PuiCPrintingPolicy int ____________________________________________________ ||||||||||||||||||||||||||||||||||| ||||||||||||||||||||||||||||||||||| PPPPuuuuiiiiNNNNbbbbuuuuffffffffeeeerrrr Specifies a buffer to be printed. This resource is used when PPPPuuuuiiiiNNNNjjjjoooobbbbTTTTyyyyppppeeee is set to PPPPuuuuiiiiPPPPRRRRIIIINNNNTTTTJJJJOOOOBBBB____BBBBUUUUFFFFFFFFEEEERRRR and is otherwise ignored. If this resource is read, the value returned is a pointer into widget private storage and must not be deallocated. PPPPuuuuiiiiNNNNbbbbuuuuffffSSSSiiiizzzzeeee Specifies the number of bytes in the buffer specified by PPPPuuuuiiiiNNNNbbbbuuuuffffffffeeeerrrr. This resource is used when PPPPuuuuiiiiNNNNjjjjoooobbbbTTTTyyyyppppeeee is set to PPPPuuuuiiiiPPPPRRRRIIIINNNNTTTTJJJJOOOOBBBB____BBBBUUUUFFFFFFFFEEEERRRR and is otherwise ignored. PPPPuuuuiiiiNNNNddddeeeeffffPPPPrrrriiiinnnntttteeeerrrr This read-only resource provides the name of the spooling system default printer. If no default printer is known to the PPPPaaaaggggeeee 6666 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) spooling system, this resource will be NULL. If a non-NULL value is returned, it is a pointer into widget private storage and must not be deallocated. PPPPuuuuiiiiNNNNffffdddd Specifies an open file descriptor from which data is to be printed. This resource is used when PPPPuuuuiiiiNNNNjjjjoooobbbbTTTTyyyyppppeeee is set to PPPPuuuuiiiiPPPPRRRRIIIINNNNTTTTJJJJOOOOBBBB____DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTOOOORRRR and is ignored otherwise. PPPPuuuuiiiiNNNNffffiiiilllleeeennnnaaaammmmeeee Specifies the name(s) of file(s) to be printed. Multiple filenames may be specified separated by whitespace. Bourne shell filename meta characters may be specified but job control and other meta characters should not be specified and may be disallowed by the widget. This resource is used when PPPPuuuuiiiiNNNNjjjjoooobbbbTTTTyyyyppppeeee is set to PPPPuuuuiiiiPPPPRRRRIIIINNNNTTTTJJJJOOOOBBBB____FFFFIIIILLLLEEEENNNNAAAAMMMMEEEE otherwise it is ignored. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNjjjjoooobbbbTTTTyyyyppppeeee The PrintBox widget can print data from three sources: files, file descriptors or buffers. PPPPuuuuiiiiNNNNjjjjoooobbbbTTTTyyyyppppeeee specifies which print source is to be used. The following table indicates the values which this resource may take: PPPPrrrriiiinnnntttt SSSSoooouuuurrrrcccceeee PPPPuuuuiiiiNNNNjjjjoooobbbbTTTTyyyyppppeeee AAAAllllssssoooo ssssppppeeeecccciiiiffffyyyy ____________________________________________________ File(s) PuiPRINTJOB_FILENAME PuiNfilename Descriptor PuiPRINTJOB_DESCRIPTOR PuiNfd Buffer PuiPRINTJOB_BUFFER PuiNbuffer, PuiNbufSize Note that the filename entry area is displayed only when PPPPuuuuiiiiNNNNjjjjoooobbbbTTTTyyyyppppeeee is set to PPPPuuuuiiiiPPPPRRRRIIIINNNNTTTTJJJJOOOOBBBB____FFFFIIIILLLLEEEENNNNAAAAMMMMEEEE and PPPPuuuuiiiiNNNNsssshhhhoooowwwwFFFFiiiilllleeeennnnaaaammmmeeee is TTTTrrrruuuueeee. PPPPuuuuiiiiNNNNnnnnuuuummmmPPPPrrrriiiinnnntttteeeerrrrssss This read-only resource indicates the number of printers currently available from the spooling system and listed in the printer selection area of the widget. PPPPuuuuiiiiNNNNpppprrrriiiinnnntttteeeerrrr Setting this resource selects the specified printer name for printing. If the specified printer is not in the list of available printers, the widget will attempt to select the system default printer. If there is no default printer, the first printer in the printer list will be selected. Reading this resource provides the name of the currently selected printer. If this resource is read, the value returned is a pointer into widget private storage and must not be deallocated. PPPPaaaaggggeeee 7777 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) PPPPuuuuiiiiNNNNpppprrrriiiinnnntttteeeerrrrLLLLiiiisssstttt This read-only resource provides the list of available printers. The list is an array with PPPPuuuuiiiiNNNNnnnnuuuummmmPPPPrrrriiiinnnntttteeeerrrrssss items each of type SSSSLLLLPPPPrrrriiiinnnntttteeeerrrrSSSSttttrrrruuuucccctttt. Refer to the man pages for _l_i_b_s_p_o_o_l(_3) and _S_L_G_e_t_P_r_i_n_t_e_r_L_i_s_t(_3_X) for more information regarding this structure. If this resource is read, the value returned is a pointer into widget private storage and must not be deallocated. PPPPuuuuiiiiNNNNpppprrrriiiinnnnttttiiiinnnnggggPPPPoooolllliiiiccccyyyy Specifies who is responsible for submitting print jobs to the spooling system. The PrintBox widget has an internal routine for submitting jobs. This routine is invoked by activating the PPPPrrrriiiinnnntttt button or by calling the _P_u_i_P_r_i_n_t_B_o_x_D_o_P_r_i_n_t(_3_X) function. If PPPPuuuuiiiiNNNNpppprrrriiiinnnnttttiiiinnnnggggPPPPoooolllliiiiccccyyyy is set to PPPPuuuuiiiiWWWWIIIIDDDDGGGGEEEETTTT____PPPPRRRRIIIINNNNTTTTIIIINNNNGGGG (the default) the internal job submittal function will be used. If this resource is set to PPPPuuuuiiiiAAAAPPPPPPPPLLLLIIIICCCCAAAATTTTIIIIOOOONNNN____PPPPRRRRIIIINNNNTTTTIIIINNNNGGGG the internal routine will not be called and it becomes the responsibility of the application to submit the print job to the spooling system. PPPPaaaaggggeeee 8888 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) ____________________________________________ PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx PPPPrrrriiiinnnntttt JJJJoooobbbb OOOOppppttttiiiioooonnnn RRRReeeessssoooouuuurrrrcccceeeessss ___________________________________________ NNNNaaaammmmeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss CCCCllllaaaassssssss TTTTyyyyppppeeee ___________________________________________ PuiNcopy dynamic SG PuiCCopy Boolean ___________________________________________ PuiNjobTitle dynamic SG PuiCJobTitle char* ___________________________________________ PuiNmail dynamic SG PuiCMail Boolean ___________________________________________ PuiNmessage dynamic SG PuiNMessage Boolean ___________________________________________ PuiNnumCopies 1 CSG PuiCNumCopies int ___________________________________________ PuiNprinterOptions dynamic SG PuiCPrinterOptions char* ___________________________________________ ||||||||||||||||||||||| ||||||||||||||||||||||| These options are similar to the command line flags for the System V _l_p command. Refer to the _l_p(_1) man page for additional information on the meaning of these options. The initial values of these resources, with the exception of PuiNnumCopies, is determined at widget creation by the contents of the spooler options file ~/._g_l_p_r_c, if it exists. New values for these resources may be specified after the PrintBox widget has been created. PPPPuuuuiiiiNNNNccccooooppppyyyy If TTTTrrrruuuueeee, specifies that the file(s) to be printed should be copied to the printer spooling directory thereby allowing the original file(s) to be modified without affecting the printed versions. If set to FFFFaaaallllsssseeee links to the actual files will be created in the spooling directory. In this case, any modifications to the file(s) will be reflected in the printed output. In the absence of a spooler options file, the value of this resource defaults to FFFFaaaallllsssseeee. PPPPuuuuiiiiNNNNjjjjoooobbbbTTTTiiiittttlllleeee Specifies a title to be printed on the banner page of the print job. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. In the absence of a spooler options file, the value of this resource defaults to NNNNUUUULLLLLLLL. PPPPaaaaggggeeee 9999 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) PPPPuuuuiiiiNNNNmmmmaaaaiiiillll If TTTTrrrruuuueeee a mail message will be sent upon completion of the print job. Otherwise, no mail will be sent. In the absence of a spooler options file, the value of this resource defaults to FFFFaaaallllsssseeee. PPPPuuuuiiiiNNNNmmmmeeeessssssssaaaaggggeeee If TTTTrrrruuuueeee an attempt will be made to print a message on the user's terminal indicating that the print job has completed. If the terminal cannot be found, a mail message will be sent. In the absence of a spooler options file, the value of this resource defaults to FFFFaaaallllsssseeee. PPPPuuuuiiiiNNNNnnnnuuuummmmCCCCooooppppiiiieeeessss Specifies the number of copies to be printed. PPPPuuuuiiiiNNNNpppprrrriiiinnnntttteeeerrrrOOOOppppttttiiiioooonnnnssss Specifies a string of printer-specific options. Multiple options may be specified separated by whitespace. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. In the absence of a spooler options file, the value of this resource defaults to NNNNUUUULLLLLLLL. PPPPaaaaggggeeee 11110000 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) _______________________________________________________________ PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx LLLLaaaayyyyoooouuuutttt RRRReeeessssoooouuuurrrrcccceeeessss ______________________________________________________________ NNNNaaaammmmeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss CCCCllllaaaassssssss TTTTyyyyppppeeee ______________________________________________________________ PuiNbusyCursor Watch CSG PuiCCursor Cursor ______________________________________________________________ PuiNbuttonPlacement PuiBUTTONS_CENTER CG PuiCButtonPlacement int ______________________________________________________________ PuiNbuttonSpacing 8 CG PuiCButtonSpacing int ______________________________________________________________ PuiNdefaultPrinterFont [see description below] CG PuiCFont XFontStruct* ______________________________________________________________ PuiNfilenameSensitive True CSG PuiCSensitive Boolean ______________________________________________________________ PuiNinsensitiveBackground SGILightGrey CSG PuiCBackground Pixel ______________________________________________________________ PuiNinsensitiveForeground black CSG PuiCForeground Pixel ______________________________________________________________ PuiNlistVisibleItemCount 8 CG PuiCVisibleItemCount int ______________________________________________________________ PuiNnumCopiesSensitive True CSG PuiCSensitive Boolean ______________________________________________________________ PuiNprinterFont [see description below] CG PuiCFont XFontStruct* ______________________________________________________________ PuiNprinterOptionsSensitive True CSG PuiCSensitive Boolean ______________________________________________________________ PuiNshowBannerTitle True CG PuiCShowBannerTitle Boolean ______________________________________________________________ PuiNshowCompletion True CG PuiCShowCompletion Boolean ______________________________________________________________ PuiNshowFilename dynamic CG PuiCShowFilename Boolean ______________________________________________________________ ||||||||||||||||||||||||||||||||||||||||||||||| ||||||||||||||||||||||||||||||||||||||||||||||| PPPPaaaaggggeeee 11111111 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) ________________________________________________ PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx LLLLaaaayyyyoooouuuutttt RRRReeeessssoooouuuurrrrcccceeeessss ((((ccccoooonnnntttt''''dddd)))) _______________________________________________ NNNNaaaammmmeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss CCCCllllaaaassssssss TTTTyyyyppppeeee _______________________________________________ PuiNshowHandling True CG PuiCShowHanding Boolean _______________________________________________ PuiNshowNumCopies True CG PuiCShowNumCopies Boolean _______________________________________________ PuiNshowOptions True CG PuiCShowOptions Boolean _______________________________________________ PuiNshowOptionsButton True CG PuiCShowOptionsButton Boolean _______________________________________________ PuiNshowPrinterOptions True CG PuiCShowPrinterOptions Boolean _______________________________________________ PuiNshowSaveButton True CG PuiCShowSaveButton Boolean _______________________________________________ ||||||||||||||||||||||| ||||||||||||||||||||||| PPPPuuuuiiiiNNNNbbbbuuuussssyyyyCCCCuuuurrrrssssoooorrrr Specifies the cursor shape to use during the period between the pressing of the MMMMoooorrrreeee OOOOppppttttiiiioooonnnnssss............ button and the actual appearance on the screen of the option dialog. PPPPuuuuiiiiNNNNbbbbuuuuttttttttoooonnnnPPPPllllaaaacccceeeemmmmeeeennnntttt The action area push buttons can be grouped on the left side, right side or center of the action area by setting this resource to PPPPuuuuiiiiBBBBUUUUTTTTTTTTOOOONNNNSSSS____LLLLEEEEFFFFTTTT, PPPPuuuuiiiiBBBBUUUUTTTTTTTTOOOONNNNSSSS____RRRRIIIIGGGGHHHHTTTT, or PPPPuuuuiiiiBBBBUUUUTTTTTTTTOOOONNNNSSSS____CCCCEEEENNNNTTTTEEEERRRR respectively. By default the buttons area centered in the action area. PPPPuuuuiiiiNNNNbbbbuuuuttttttttoooonnnnSSSSppppaaaacccciiiinnnngggg Specifies the horizontal spacing between the push buttons in the action area. PPPPuuuuiiiiNNNNddddeeeeffffaaaauuuullllttttPPPPrrrriiiinnnntttteeeerrrrFFFFoooonnnntttt Specifies the font in which the default printer should be displayed on the available printers list. Typically, the font selected will be a bold version of the font specified by PPPPuuuuiiiiNNNNpppprrrriiiinnnntttteeeerrrrFFFFoooonnnntttt. The font selected should be a fixed width font. If this resource is read, the value returned is a pointer into widget private storage and must not be deallocated. The default for this resource is ----****----ssssccccrrrreeeeeeeennnn----bbbboooolllldddd----rrrr----nnnnoooorrrrmmmmaaaallll----****----11115555****. PPPPaaaaggggeeee 11112222 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) PPPPuuuuiiiiNNNNffffiiiilllleeeennnnaaaammmmeeeeSSSSeeeennnnssssiiiittttiiiivvvveeee If set to TTTTrrrruuuueeee, the filename text field will permit user input of filenames. If set to FFFFaaaallllsssseeee, the field will not accept input, the background of the field will be set to the color specified by the PPPPuuuuiiiiNNNNiiiinnnnsssseeeennnnssssiiiittttiiiivvvveeeeBBBBaaaacccckkkkggggrrrroooouuuunnnndddd resource and the foreground will be set to the color specified by PPPPuuuuiiiiNNNNiiiinnnnsssseeeennnnssssiiiittttiiiivvvveeeeFFFFoooorrrreeeeggggrrrroooouuuunnnndddd. PPPPuuuuiiiiNNNNiiiinnnnsssseeeennnnssssiiiittttiiiivvvveeeeBBBBaaaacccckkkkggggrrrroooouuuunnnndddd Specifies the background color for text entry fields when they are in an insensitive state. PPPPuuuuiiiiNNNNiiiinnnnsssseeeennnnssssiiiittttiiiivvvveeeeFFFFoooorrrreeeeggggrrrroooouuuunnnndddd Specifies the foreground color for text entry fields when they are in an insensitive state. PPPPuuuuiiiiNNNNlllliiiissssttttVVVViiiissssiiiibbbblllleeeeIIIItttteeeemmmmCCCCoooouuuunnnntttt Specifies the number of lines to display for the available printers list. This resource is ignored if the job option area is displayed (sssshhhhoooowwwwOOOOppppttttiiiioooonnnnssss is TTTTrrrruuuueeee). In this case the number of lines displayed is determined by the height of the job option area. PPPPuuuuiiiiNNNNnnnnuuuummmmCCCCooooppppiiiieeeessssSSSSeeeennnnssssiiiittttiiiivvvveeee If set to TTTTrrrruuuueeee, the copies text field will permit user input for the number of copies. If set to FFFFaaaallllsssseeee, the field will not accept input, the background of the field will be set to the color specified by the PPPPuuuuiiiiNNNNiiiinnnnsssseeeennnnssssiiiittttiiiivvvveeeeBBBBaaaacccckkkkggggrrrroooouuuunnnndddd resource and the foreground will be set to the color specified by PPPPuuuuiiiiNNNNiiiinnnnsssseeeennnnssssiiiittttiiiivvvveeeeFFFFoooorrrreeeeggggrrrroooouuuunnnndddd. PPPPuuuuiiiiNNNNpppprrrriiiinnnntttteeeerrrrFFFFoooonnnntttt Specifies the font in which the available printer list should be displayed. Typically, the font selected will be a non-bold version version of the font used for the default printer. The font selected should be a fixed width font. If this resource is read, the value returned is a pointer into widget private storage and must not be deallocated. The default for this resource is ----****----ssssccccrrrreeeeeeeennnn----mmmmeeeeddddiiiiuuuummmm----rrrr----nnnnoooorrrrmmmmaaaallll----****----11115555****. PPPPuuuuiiiiNNNNpppprrrriiiinnnntttteeeerrrrOOOOppppttttiiiioooonnnnssssSSSSeeeennnnssssiiiittttiiiivvvveeee If set to TTTTrrrruuuueeee, the printer-specific options text field will permit user input. If set to FFFFaaaallllsssseeee, the field will not accept input, the background of the field will be set to the color specified by the PPPPuuuuiiiiNNNNiiiinnnnsssseeeennnnssssiiiittttiiiivvvveeeeBBBBaaaacccckkkkggggrrrroooouuuunnnndddd resource and the foreground will be set to the color specified by PPPPuuuuiiiiNNNNiiiinnnnsssseeeennnnssssiiiittttiiiivvvveeeeFFFFoooorrrreeeeggggrrrroooouuuunnnndddd. PPPPuuuuiiiiNNNNsssshhhhoooowwwwBBBBaaaannnnnnnneeeerrrrTTTTiiiittttlllleeee If set to FFFFaaaallllsssseeee, the banner page title options will not be displayed. PPPPaaaaggggeeee 11113333 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) PPPPuuuuiiiiNNNNsssshhhhoooowwwwCCCCoooommmmpppplllleeeettttiiiioooonnnn If set to FFFFaaaallllsssseeee, the job completion notification options will not be displayed. PPPPuuuuiiiiNNNNsssshhhhoooowwwwFFFFiiiilllleeeennnnaaaammmmeeee If set to FFFFaaaallllsssseeee the filename entry area will not be displayed. Note that when PPPPuuuuiiiiNNNNjjjjoooobbbbTTTTyyyyppppeeee is set to PPPPuuuuiiiiNNNNPPPPRRRRIIIINNNNTTTTJJJJOOOOBBBB____BBBBUUUUFFFFFFFFEEEERRRR or PPPPuuuuiiiiPPPPRRRRIIIINNNNTTTTJJJJOOOOBBBB____DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTOOOORRRR the filename entry area is not displayed regardless of the value of this resource. PPPPuuuuiiiiNNNNsssshhhhoooowwwwHHHHaaaannnnddddlllliiiinnnngggg If set to FFFFaaaallllsssseeee, the print file handling options will not be displayed. PPPPuuuuiiiiNNNNsssshhhhoooowwwwNNNNuuuummmmCCCCooooppppiiiieeeessss If set to FFFFaaaallllsssseeee, the number of copies option will not be displayed. PPPPuuuuiiiiNNNNsssshhhhoooowwwwOOOOppppttttiiiioooonnnnssss If set to FFFFaaaallllsssseeee, the job option area will not be displayed. PPPPuuuuiiiiNNNNsssshhhhoooowwwwOOOOppppttttiiiioooonnnnssssBBBBuuuuttttttttoooonnnn If set to FFFFaaaallllsssseeee, the MMMMoooorrrreeee OOOOppppttttiiiioooonnnnssss............ button will not be displayed in the action area. PPPPuuuuiiiiNNNNsssshhhhoooowwwwPPPPrrrriiiinnnntttteeeerrrrOOOOppppttttiiiioooonnnnssss If set to FFFFaaaallllsssseeee, the printer-specific options will not be displayed. PPPPuuuuiiiiNNNNsssshhhhoooowwwwSSSSaaaavvvveeeeBBBBuuuuttttttttoooonnnn If set to FFFFaaaallllsssseeee, the SSSSaaaavvvveeee OOOOppppttttiiiioooonnnnssss............ button will not be displayed in the action area. PPPPaaaaggggeeee 11114444 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) ______________________________________________________________ PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx LLLLaaaabbbbeeeellll RRRReeeessssoooouuuurrrrcccceeeessss _____________________________________________________________ NNNNaaaammmmeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss CCCCllllaaaassssssss TTTTyyyyppppeeee _____________________________________________________________ PuiNcancelLabelString "Cancel" CSG PuiCCancelLabelString XmString _____________________________________________________________ PuiNcompletionLabelString [see desc. below] CSG PuiCCompletionLabelString XmString _____________________________________________________________ PuiNcopyJobLabelString [see desc. below] CSG PuiCCopyJobLabelString XmString _____________________________________________________________ PuiNfilenameLabelString "Files to print:" CSG PuiCFilenameLabelString XmString _____________________________________________________________ PuiNhandlingLabelString [see desc.below] CSG PuiCHandlingLabelString XmString _____________________________________________________________ PuiNhelpLabelString "Help" CSG PuiCHelpLabelString XmString _____________________________________________________________ PuiNjobDefTitleLabelString "Default" CSG PuiCJobDefTitleLabelString XmString _____________________________________________________________ PuiNjobSpecTitleLabelString "Custom:" CSG PuiCJobSpecTitleLabelString XmString _____________________________________________________________ PuiNjobTitleLabelString "Banner page title:" CSG PuiCJobTitleLabelString XmString _____________________________________________________________ PuiNlinkJobLabelString [see desc. below] CSG PuiCLinkJobLabelString XmString _____________________________________________________________ PuiNmailLabelString "Send mail" CSG PuiCMailLabelString XmString _____________________________________________________________ PuiNmessageLabelString [see desc. below] CSG PuiCMessageLabelString XmString _____________________________________________________________ PuiNnumCopiesLabelString "Number of copies:" CSG PuiCNumCopiesLabelString XmString _____________________________________________________________ PuiNoptionLabelString "Options:" CSG PuiCOptionLabelString XmString _____________________________________________________________ ||||||||||||||||||||||||||||||||||||||||||||||| ||||||||||||||||||||||||||||||||||||||||||||||| PPPPaaaaggggeeee 11115555 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) ________________________________________________________________ PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx LLLLaaaabbbbeeeellll RRRReeeessssoooouuuurrrrcccceeeessss ((((ccccoooonnnntttt''''dddd)))) _______________________________________________________________ NNNNaaaammmmeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss CCCCllllaaaassssssss TTTTyyyyppppeeee _______________________________________________________________ PuiNoptionsbLabelString "More Options..." CSG PuiCOptionsbLabelString XmString _______________________________________________________________ PuiNprinterLabelString "Available printers:" CSG PuiCPrinterLabelString XmString _______________________________________________________________ PuiNprinterSpecLabelString [see desc. below] CSG PuiCPrinterSpecLabelString XmString _______________________________________________________________ PuiNprintLabelString "Print" CSG PuiCPrintLabelString XmString _______________________________________________________________ PuiNsaveLabelString "Save Options..." CSG PuiCSaveLabelString XmString _______________________________________________________________ PuiNsaveDlgTitleLabelString "Save Settings" CSG PuiCSaveDlgTitleLabelString XmString _______________________________________________________________ PuiNsaveDlgSaveLabelString "Save" CSG PuiCSaveDlgSaveLabelString XmString _______________________________________________________________ PuiNsaveDlgUserLabelString "Save - Personal" CSG PuiCSaveDlgUserLabelString XmString _______________________________________________________________ PuiNsaveDlgAllLabelString "Save - All Users" CSG PuiCSaveDlgAllLabelString XmString _______________________________________________________________ PuiNsaveDlgCancelLabelString "Cancel" CSG PuiCSaveDlgCancelLabelString XmString _______________________________________________________________ PuiNsaveDlgMsgLabelString [see desc. below] CSG PuiCSaveDlgMsgLabelString XmString _______________________________________________________________ PuiNuser1LabelString "User1" CSG PuiCUser1LabelString XmString _______________________________________________________________ PuiNuser2LabelString "User2" CSG PuiCUser2LabelString XmString _______________________________________________________________ |||||||||||||||||||||||||||||||||||||||||||| |||||||||||||||||||||||||||||||||||||||||||| PPPPaaaaggggeeee 11116666 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) _______________________________________________ PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx LLLLaaaabbbbeeeellll RRRReeeessssoooouuuurrrrcccceeeessss ((((ccccoooonnnntttt''''dddd)))) ______________________________________________ NNNNaaaammmmeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss CCCCllllaaaassssssss TTTTyyyyppppeeee ______________________________________________ PuiNuser3LabelString "User3" CSG PuiCUser3LabelString XmString ______________________________________________ PuiNuser4LabelString "User4" CSG PuiCUser4LabelString XmString ______________________________________________ ||||||||||| ||||||||||| PPPPuuuuiiiiNNNNccccaaaannnncccceeeellllLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the label for the CCCCaaaannnncccceeeellll button. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNccccoooommmmpppplllleeeettttiiiioooonnnnLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the label for the print job completion notification option. The default value for this option is "When job is complete:". If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNccccooooppppyyyyJJJJoooobbbbLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the label for the print file copy handling option. The default value for this option is "Copy to spool directory". If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNffffiiiilllleeeennnnaaaammmmeeeeLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the section title for the filename entry area. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNhhhhaaaannnnddddlllliiiinnnnggggLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the label for the print file handling option. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. The default value for this resource is "Print file handling:". PPPPuuuuiiiiNNNNhhhheeeellllppppLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the label for the HHHHeeeellllpppp button. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPaaaaggggeeee 11117777 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) PPPPuuuuiiiiNNNNjjjjoooobbbbDDDDeeeeffffTTTTiiiittttlllleeeeLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the label for the default banner page title option. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNjjjjoooobbbbSSSSppppeeeeccccTTTTiiiittttlllleeeeLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the label for the user specified banner page title option. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNjjjjoooobbbbTTTTiiiittttlllleeeeLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the label for the banner page title options. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNlllliiiinnnnkkkkJJJJoooobbbbLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the label for the link print file handling option. The default value for this option is "Link in spool directory". If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNmmmmaaaaiiiillllLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the label for the send mail upon job completion option. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNmmmmeeeessssssssaaaaggggeeeeLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the label for the console message upon completion option. The default value for this option is "Send message to console". If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PuiNnumCopiesLabelString Specifies the label for the number of copies option. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNooooppppttttiiiioooonnnnLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the section title for the job option area. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNooooppppttttiiiioooonnnnssssbbbbLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the label for the MMMMoooorrrreeee OOOOppppttttiiiioooonnnnssss............ button. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) PPPPaaaaggggeeee 11118888 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) when no longer needed. PPPPuuuuiiiiNNNNpppprrrriiiinnnntttteeeerrrrLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the section title for the printer selection area. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNpppprrrriiiinnnntttteeeerrrrSSSSppppeeeeccccLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the label for the printer-specific options. The default value for this option is "Printer-specific options:". If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNpppprrrriiiinnnnttttLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the label for the PPPPrrrriiiinnnntttt button. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNssssaaaavvvveeeeLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the label for the SSSSaaaavvvveeee OOOOppppttttiiiioooonnnnssss............ button. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNssssaaaavvvveeeeDDDDllllggggTTTTiiiittttlllleeeeLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the title of the options save dialog box. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNssssaaaavvvveeeeDDDDllllggggSSSSaaaavvvveeeeLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the label for the SSSSaaaavvvveeee button on the options save dialog box. This label is used when the user is not "root" or "lp". If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNssssaaaavvvveeeeDDDDllllggggUUUUsssseeeerrrrLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the label for the save personal settings button on the save options dialog box. This button appears when the user is "root" or "lp". If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNssssaaaavvvveeeeDDDDllllggggAAAAllllllllLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the label for the save default settings button on the save options dialog box. This button appears when the user is "root" or "lp". If this resource is read and the value is not NULL, the storage associated with this resource should be freed PPPPaaaaggggeeee 11119999 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNssssaaaavvvveeeeDDDDllllggggCCCCaaaannnncccceeeellllLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the label for the CCCCaaaannnncccceeeellll button on the save options dialog box. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNssssaaaavvvveeeeDDDDllllggggMMMMssssggggLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the explanatory message that appears at the top of the save options dialog box. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. The default value for this resource is "Save spooler settings.<nl><nl>In addition, save printer-specific settings for:". PPPPuuuuiiiiNNNNuuuusssseeeerrrr1111LLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the label for the UUUUsssseeeerrrr1111 button. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNuuuusssseeeerrrr2222LLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the label for the UUUUsssseeeerrrr2222 button. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNuuuusssseeeerrrr3333LLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the label for the UUUUsssseeeerrrr3333 button. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPuuuuiiiiNNNNuuuusssseeeerrrr4444LLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg Specifies the label for the UUUUsssseeeerrrr4444 button. If this resource is read and the value is not NULL, the storage associated with this resource should be freed using _X_t_F_r_e_e(_3_X_t) when no longer needed. PPPPaaaaggggeeee 22220000 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) ________________________________________________________ PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx CCCCaaaallllllllbbbbaaaacccckkkk RRRReeeessssoooouuuurrrrcccceeeessss _______________________________________________________ NNNNaaaammmmeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss CCCCllllaaaassssssss TTTTyyyyppppeeee _______________________________________________________ PuiNcancelCallback NULL C PuiCCallback XtCallbackList _______________________________________________________ PuiNerrorCallback NULL C PuiCCallback XtCallbackList _______________________________________________________ PuiNhelpCallback NULL C PuiCCallback XtCallbackList _______________________________________________________ PuiNjobInfoCallback NULL C PuiCCallback XtCallbackList _______________________________________________________ PuiNoptionErrorCallback NULL C PuiCCallback XtCallbackList _______________________________________________________ PuiNprintCallback NULL C PuiCCallback XtCallbackList _______________________________________________________ PuiNprinterActionCallback NULL C PuiCCallback XtCallbackList _______________________________________________________ PuiNprinterSelectCallback NULL C PuiCCallback XtCallbackList _______________________________________________________ PuiNuser1Callback NULL C PuiCCallback XtCallbackList _______________________________________________________ PuiNuser2Callback NULL C PuiCCallback XtCallbackList _______________________________________________________ PuiNuser3Callback NULL C PuiCCallback XtCallbackList _______________________________________________________ PuiNuser4Callback NULL C PuiCCallback XtCallbackList _______________________________________________________ ||||||||||||||||||||||||||||||||||||||||| ||||||||||||||||||||||||||||||||||||||||| PPPPuuuuiiiiNNNNccccaaaannnncccceeeellllCCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callback functions called when the user activates the CCCCaaaannnncccceeeellll button. The callback reason is PPPPuuuuiiiiCCCCRRRR____CCCCAAAANNNNCCCCEEEELLLL. PPPPuuuuiiiiNNNNeeeerrrrrrrroooorrrrCCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callback functions called when an error has occurred in the submittal of a print job. An error can also be triggered by other interactions with the spooling system PPPPaaaaggggeeee 22221111 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) such as determining the available printers. The callback reason is PPPPuuuuiiiiCCCCRRRR____EEEERRRRRRRROOOORRRR. Error caused by executing a printer options dialog are reported on the PPPPuuuuiiiiNNNNooooppppttttiiiioooonnnnEEEErrrrrrrroooorrrrCCCCaaaallllllllbbbbaaaacccckkkk. PPPPuuuuiiiiNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callback functions called when the user activates the HHHHeeeellllpppp button. The callback reason is PPPPuuuuiiiiCCCCRRRR____HHHHEEEELLLLPPPP. PPPPuuuuiiiiNNNNjjjjoooobbbbIIIInnnnffffooooCCCCaaaallllllllbbbbaaaacccckkkk When a print job has been successfully submitted to the spooling system the functions on this callback list will be called. The callback data will provide information on the job. The callback reason is PPPPuuuuiiiiCCCCRRRR____JJJJOOOOBBBB____IIIINNNNFFFFOOOO. PPPPuuuuiiiiNNNNooooppppttttiiiioooonnnnEEEErrrrrrrroooorrrrCCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callback functions called when an error has occurred while executing a printer-specific option panel program. The callback reason is PPPPuuuuiiiiCCCCRRRR____OOOOPPPPTTTT____EEEERRRRRRRROOOORRRR. Printing errors are reported on the PPPPuuuuiiiiNNNNeeeerrrrrrrroooorrrrCCCCaaaallllllllbbbbaaaacccckkkk. PPPPuuuuiiiiNNNNpppprrrriiiinnnnttttCCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callback functions called when the user activates the PPPPrrrriiiinnnntttt button or calls the _P_u_i_P_r_i_n_t_B_o_x_D_o_P_r_i_n_t(_3_X) function. The callback reason is PPPPuuuuiiiiCCCCRRRR____PPPPRRRRIIIINNNNTTTT. This callback provides a number of capabilities. If PPPPuuuuiiiiNNNNpppprrrriiiinnnnttttiiiinnnnggggPPPPoooolllliiiiccccyyyy is PPPPuuuuiiiiWWWWIIIIDDDDGGGGEEEETTTT____PPPPRRRRIIIINNNNTTTTIIIINNNNGGGG (the default), the functions on this callback are called before any printing is performed by the widget. This allows the application to perform any pre-printing processing such as setting a busy cursor or specifying a buffer for the _P_u_i_P_r_i_n_t_B_o_x widget to print. Upon return from the last user specified callback function, the widget will submit a print job. If PPPPuuuuiiiiNNNNpppprrrriiiinnnnttttiiiinnnnggggPPPPoooolllliiiiccccyyyy is PPPPuuuuiiiiAAAAPPPPPPPPLLLLIIIICCCCAAAATTTTIIIIOOOONNNN____PPPPRRRRIIIINNNNTTTTIIIINNNNGGGG, this callback would be used by the application to submit a print job using its own printing method. PPPPuuuuiiiiNNNNpppprrrriiiinnnntttteeeerrrrAAAAccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callback functions called when a printer on the available printer list is double clicked. The callback reason is PPPPuuuuiiiiCCCCRRRR____PPPPRRRR____AAAACCCCTTTTIIIIOOOONNNN. PPPPuuuuiiiiNNNNpppprrrriiiinnnntttteeeerrrrSSSSeeeelllleeeeccccttttCCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callback functions called when a printer is selected from the available printer list. These callbacks are also called when a new printer is selected using the PPPPuuuuiiiiNNNNpppprrrriiiinnnntttteeeerrrr resource. The callback reason is PPPPuuuuiiiiCCCCRRRR____PPPPRRRR____SSSSEEEELLLLEEEECCCCTTTT. PPPPuuuuiiiiNNNNuuuusssseeeerrrr1111CCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callback functions called when the user activates the UUUUsssseeeerrrr1111 button. The callback reason is PPPPuuuuiiiiCCCCRRRR____UUUUSSSSEEEERRRR1111. PPPPaaaaggggeeee 22222222 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) PPPPuuuuiiiiNNNNuuuusssseeeerrrr2222CCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callback functions called when the user activates the UUUUsssseeeerrrr2222 button. The callback reason is PPPPuuuuiiiiCCCCRRRR____UUUUSSSSEEEERRRR2222. PPPPuuuuiiiiNNNNuuuusssseeeerrrr3333CCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callback functions called when the user activates the UUUUsssseeeerrrr3333 button. The callback reason is PPPPuuuuiiiiCCCCRRRR____UUUUSSSSEEEERRRR3333. PPPPuuuuiiiiNNNNuuuusssseeeerrrr4444CCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callback functions called when the user activates the UUUUsssseeeerrrr4444 button. The callback reason is PPPPuuuuiiiiCCCCRRRR____UUUUSSSSEEEERRRR4444. IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss The PrintBox widget inherits behavior and resources from the following superclasses. For a complete description of each resource, refer to the man page for that superclass. PPPPaaaaggggeeee 22223333 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) ___________________________________________________ XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd RRRReeeessssoooouuuurrrrcccceeeessss __________________________________________________ NNNNaaaammmmeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss CCCCllllaaaassssssss TTTTyyyyppppeeee __________________________________________________ XmNallowOverlap True CSG XmCAllowOverlap Boolean __________________________________________________ XmNautoUnmanage True CG XmCAutoUnmanage Boolean __________________________________________________ XmNbuttonFontList dynamic CSG XmCButtonFontList XmFontList __________________________________________________ XmNcancelButton dynamic SG XmCWidget Widget __________________________________________________ XmNdefaultButton dynamic SG XmCWidget Widget __________________________________________________ XmNdefaultPosition True CSG XmCDefaultPosition Boolean __________________________________________________ XmNdialogStyle dynamic CSG XmCDialogStyle unsigned char __________________________________________________ XmNdialogTitle NULL CSG XmCDialogTitle XmString __________________________________________________ XmNfocusCallback NULL C XmCCallback XtCallbackList __________________________________________________ XmNlabelFontList dynamic CSG XmCLabelFontList XmFontList __________________________________________________ XmNmapCallback NULL C XmCCallback XtCallbackList __________________________________________________ XmNmarginHeight 10 CSG XmCMarginHeight Dimension __________________________________________________ XmNmarginWidth 10 CSG XmCMarginWidth Dimension __________________________________________________ XmNnoResize False CSG XmCNoResize Boolean __________________________________________________ ||||||||||||||||||||||||||||||||||||||||||||||| ||||||||||||||||||||||||||||||||||||||||||||||| PPPPaaaaggggeeee 22224444 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) __________________________________________________ XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd RRRReeeessssoooouuuurrrrcccceeeessss ((((ccccoooonnnntttt''''dddd)))) _________________________________________________ NNNNaaaammmmeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss CCCCllllaaaassssssss TTTTyyyyppppeeee _________________________________________________ XmNresizePolicy XmRESIZE_ANY CSG XmCResizePolicy unsigned char _________________________________________________ XmNshadowType XmSHADOW_OUT CSG XmCShadowType unsigned char _________________________________________________ XmNtextFontList dynamic CSG XmCTextFontList XmFontList _________________________________________________ XmNtextTranslations NULL C XmCTranslations XtTranslations _________________________________________________ XmNunmapCallbackXt NULL C XmCCallback XtCallbackList _________________________________________________ |||||||||||||||||||| |||||||||||||||||||| PPPPaaaaggggeeee 22225555 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) _______________________________________________________________ XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeeessss ______________________________________________________________ NNNNaaaammmmeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss CCCCllllaaaassssssss TTTTyyyyppppeeee ______________________________________________________________ XmNbottomShadowColor dynamic CSG XmCBottomShadowColor Pixel ______________________________________________________________ XmNbottomShadowPixmap XmUNSPECIFIED_PIXMAP CSG XmCBottomShadowPixmap Pixmap ______________________________________________________________ XmNforeground dynamic CSG XmCForeground Pixel ______________________________________________________________ XmNhelpCallback NULL C XmCCallback XtCallbackList ______________________________________________________________ XmNhighlightColor dynamic CSG XmCHighlightColor Pixel ______________________________________________________________ XmNhighlightPixmap dynamic CSG XmCHighlightPixmap Pixmap ______________________________________________________________ XmNinitialFocus NULL CSG XmCInitialFocus Widget ______________________________________________________________ XmNnavigationType dynamic CSG XmCNavigationType XmNavigationType ______________________________________________________________ XmNshadowThickness dynamic CSG XmCShadowThickness Dimension ______________________________________________________________ XmNstringDirection dynamic CG XmCStringDirection XmStringDirection ______________________________________________________________ XmNtopShadowColor dynamic CSG XmCBackgroundTopShadowColor Pixel ______________________________________________________________ XmNtopShadowPixmap dynamic CSG XmCTopShadowPixmap Pixmap ______________________________________________________________ XmNtraversalOn True CSG XmCTraversalOn Boolean ______________________________________________________________ |||||||||||||||||||||||||||||||||||||||||||| |||||||||||||||||||||||||||||||||||||||||||| PPPPaaaaggggeeee 22226666 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) ___________________________________________ XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeeessss ((((ccccoooonnnntttt''''dddd)))) __________________________________________ NNNNaaaammmmeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss CCCCllllaaaassssssss TTTTyyyyppppeeee __________________________________________ XmNunitType dynamic CSG XmCUnitType unsigned char __________________________________________ XmNuserData NULL CSG XmCUserData Pointer __________________________________________ ||||||||||| ||||||||||| PPPPaaaaggggeeee 22227777 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) ______________________________________________ CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeeessss _____________________________________________ NNNNaaaammmmeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss CCCCllllaaaassssssss TTTTyyyyppppeeee _____________________________________________ XmNchildren NULL G XmCReadOnly WidgetList _____________________________________________ XmNinsertPosition NULL CSG XmCInsertPosition (*)() _____________________________________________ XmNnumChildren 0 G XmCReadOnly Cardinal _____________________________________________ |||||||||||||| |||||||||||||| PPPPaaaaggggeeee 22228888 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) ________________________________________________________________ CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeeessss _______________________________________________________________ NNNNaaaammmmeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss CCCCllllaaaassssssss TTTTyyyyppppeeee _______________________________________________________________ XmNaccelerators dynamic N/A XmCAccelerators XtAccelerators _______________________________________________________________ XmNancestorSensitive dynamic G XmCSensitive Boolean _______________________________________________________________ XmNbackground dynamic CSG XmCBackground Pixel _______________________________________________________________ XmNbackgroundPixmap XmUNSPECIFIED_PIXMAP CSG XmCPixmap Pixmap _______________________________________________________________ XmNborderColor XtDefaultForeground CSG XmCBorderColor Pixel _______________________________________________________________ XmNborderPixmap XmUNSPECIFIED_PIXMAP CSG XmCPixmap Pixmap _______________________________________________________________ XmNborderWidth 0 CSG XmCBorderWidth Dimension _______________________________________________________________ XmNcolormap dynamic CG XmCColormap Colormap _______________________________________________________________ XmNdepth dynamic CG XmCDepth int _______________________________________________________________ XmNdestroyCallback NULL C XmCCallback XtCallbackList _______________________________________________________________ XmNheight dynamic CSG XmCHeight Dimension _______________________________________________________________ XmNinitialResourcesPersistent True C XmCInitialResourcesPersistent Boolean _______________________________________________________________ XmNmappedWhenManaged True CSG XmCMappedWhenManaged Boolean _______________________________________________________________ XmNscreen dynamic CG XmCScreen Screen* _______________________________________________________________ ||||||||||||||||||||||||||||||||||||||||||||||| ||||||||||||||||||||||||||||||||||||||||||||||| PPPPaaaaggggeeee 22229999 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) ________________________________________________ CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeeessss ((((ccccoooonnnntttt''''dddd)))) _______________________________________________ NNNNaaaammmmeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss CCCCllllaaaassssssss TTTTyyyyppppeeee _______________________________________________ XmNsensitive True CSG XmCSensitive Boolean _______________________________________________ XmNtranslations dynamic CSG XmCTranslations XtTranslations _______________________________________________ XmNwidth dynamic CSG XmCWidth Dimension _______________________________________________ XmNx 0 CSG XmCPosition Position _______________________________________________ XmNy 0 CSG XmCPosition Position _______________________________________________ |||||||||||||||||||| |||||||||||||||||||| PPPPaaaaggggeeee 33330000 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn A pointer to the following structure is passed as _c_a_l_l__d_a_t_a to each callback function: ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt ____PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxxCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt {{{{ iiiinnnntttt _r_e_a_s_o_n; XXXXEEEEvvvveeeennnntttt *_e_v_e_n_t; SSSSLLLLPPPPrrrriiiinnnnttttJJJJoooobbbb *_j_o_b__i_n_f_o; cccchhhhaaaarrrr *_s_e_l_e_c_t_e_d__p_r_i_n_t_e_r; iiiinnnntttt _s_e_l_e_c_t_e_d__p_o_s_i_t_i_o_n; iiiinnnntttt _e_r_r_o_r__c_o_d_e; }}}} PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxxCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt; _r_e_a_s_o_n Indicates why the callback was invoked. _e_v_e_n_t Points to the X event that triggered the callback. _j_o_b__i_n_f_o Provides print job submittal information. _s_e_l_e_c_t_e_d__p_r_i_n_t_e_r Provides the name of the printer selected from the list of available printers. This string is a pointer to internal storage and must not be deallocated or reallocated by the user. Copy the string to user allocated storage to preserve it across callbacks. _s_e_l_e_c_t_e_d__p_o_s_i_t_i_o_n Provides the position of the selected printer in the list of available printers. For consistency with the Motif List widget the position of items start with 1 instead of 0. _e_r_r_o_r__c_o_d_e Provides an error condition code. If the callback reason is PPPPuuuuiiiiCCCCRRRR____EEEERRRRRRRROOOORRRR, the error code is the _l_i_b_s_p_o_o_l error code reported by SSSSLLLLeeeerrrrrrrrnnnnoooo. Refer to the man pages for _l_i_b_s_p_o_o_l(_3) and _S_L_P_e_r_r_o_r(_3_X) for more information. If the callback reason is PPPPuuuuiiiiCCCCRRRR____OOOOPPPPTTTT____EEEERRRRRRRROOOORRRR, the error code is the standard system error code reported by eeeerrrrrrrrnnnnoooo. Not all callback fields are relevant for all callback conditions. The reason field indicates which callback structure fields are valid. The valid fields for each reason are summarized in the following table: RRRReeeeaaaassssoooonnnn VVVVaaaalllliiiidddd FFFFiiiieeeellllddddssss ___________________________________________ PuiCR_PRINT _r_e_a_s_o_n, _e_v_e_n_t PuiCR_CANCEL _r_e_a_s_o_n, _e_v_e_n_t PuiCR_HELP _r_e_a_s_o_n, _e_v_e_n_t PuiCR_USER1 _r_e_a_s_o_n, _e_v_e_n_t PuiCR_USER2 _r_e_a_s_o_n, _e_v_e_n_t PPPPaaaaggggeeee 33331111 PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPuuuuiiiiPPPPrrrriiiinnnnttttBBBBooooxxxx((((3333XXXX)))) PuiCR_USER3 _r_e_a_s_o_n, _e_v_e_n_t PuiCR_USER4 _r_e_a_s_o_n, _e_v_e_n_t PuiCR_JOB_INFO _r_e_a_s_o_n, _j_o_b__i_n_f_o PuiCR_PR_SELECT _r_e_a_s_o_n, _s_e_l_e_c_t_e_d__p_r_i_n_t_e_r, _s_e_l_e_c_t_e_d__p_o_s_i_t_i_o_n PuiCR_PR_ACTION _r_e_a_s_o_n, _s_e_l_e_c_t_e_d__p_r_i_n_t_e_r, _s_e_l_e_c_t_e_d__p_o_s_i_t_i_o_n PuiCR_ERROR _r_e_a_s_o_n, _e_r_r_o_r__c_o_d_e PuiCR_OPT_ERROR _r_e_a_s_o_n, _e_r_r_o_r__c_o_d_e TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss The PrintBox widget inherits its translations from the XmBulletinBoard widget class. NNNNOOOOTTTTEEEESSSS 1. The PrintBox widget determines what printers are available when it is instantiated. Therefore, the PPPPuuuuiiiiNNNNpppprrrriiiinnnntttteeeerrrrLLLLiiiisssstttt, PPPPuuuuiiiiNNNNnnnnuuuummmmPPPPrrrriiiinnnntttteeeerrrrssss, and PPPPuuuuiiiiNNNNddddeeeeffffPPPPrrrriiiinnnntttteeeerrrr resources are not updated if the printing environment changes during the PrintBox widget's lifetime. 2. The PrintBox widget can report an error condition on its PPPPuuuuiiiiNNNNeeeerrrrrrrroooorrrrCCCCaaaallllllllbbbbaaaacccckkkk during initial management and realization if the System V print spooling scheduler _l_p_s_c_h_e_d is not running or if an error occurs determining the list of available printers. Applications with functions registered on this callback list should be prepared to handle errors at this point in the PrintBox widget life cycle. 4. Do not set a new value for the PPPPuuuuiiiiNNNNpppprrrriiiinnnntttteeeerrrrOOOOppppttttiiiioooonnnnssss resource while a printer-specific option panel is displayed. The printer-specific options selected in the option panel will override the options set by the resource. 5. The printer selection list should use fixed width fonts for both the regular printers and the default printer. A fixed width font will preserve the columnar organization of the list items. 6. When the PrintBox widget is instantiated it determines the username based on the current real UID. The username is used for the reading and saving option settings. If the real UID is changed programmatically after the PrintBox has been instantiated, the widget must be destroyed and re-instantiated if it is to save options for the new UID. SSSSEEEEEEEE AAAALLLLSSSSOOOO PuiCreatePrintBox(3X), PuiCreatePrintDialog(3X), libprintui(3X), libspool(3) PPPPaaaaggggeeee 33332222